Update Functions chapter of Lisp manual; document closures.
authorChong Yidong <cyd@gnu.org>
Sat, 4 Feb 2012 14:56:32 +0000 (22:56 +0800)
committerChong Yidong <cyd@gnu.org>
Sat, 4 Feb 2012 14:56:32 +0000 (22:56 +0800)
commit8bdb0758dd8e64dd2025a5aac1f5f13008a6d46c
tree997b91b3402b92c1c4149fd1c151c0be23f88e14
parentcc334461681178af2eca641c94080c97061f9928
Update Functions chapter of Lisp manual; document closures.

* doc/emacs/functions.texi (What Is a Function): Add closures.  Mention
"return value" terminology.  Add xref for command-execute.  Remove
unused "keystroke command" terminology.
(Lambda Expressions): Give a different example than in the
following subsection.  Add xref to Anonymous Functions.
(Function Documentation): Remove gratuitous markup.
(Function Names): Move introductory text to `What Is a Function'.
(Defining Functions): Fix defun argument spec.
(Anonymous Functions): Document lambda macro explicitly.  Mention
effects on lexical binding.
(Function Cells): Downplay direct usage of fset.
(Closures): New node.
(Inline Functions): Remove "open-code" terminology.
(Declaring Functions): Minor tweak; .m is not C code.

* doc/emacs/variables.texi (Variables): Don't refer to "global value".
(Local Variables, Void Variables): Copyedits.
(Lexical Binding): Minor clarification of example.
(File Local Variables): Mention :safe and :risky defcustom args.
(Lexical Binding): Add xref to Closures node.
admin/FOR-RELEASE
doc/lispref/ChangeLog
doc/lispref/elisp.texi
doc/lispref/functions.texi
doc/lispref/variables.texi
doc/lispref/vol1.texi
doc/lispref/vol2.texi
etc/NEWS